home *** CD-ROM | disk | FTP | other *** search
XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt - A function that converts a character string to a compound string SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/Xm.h> XXXXmmmmSSSSttttrrrriiiinnnngggg XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt( XXXXttttPPPPooooiiiinnnntttteeeerrrr tttteeeexxxxtttt, XXXXttttPPPPooooiiiinnnntttteeeerrrr ****tttteeeexxxxtttt____eeeennnndddd, XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaagggg ttttaaaagggg, XXXXmmmmTTTTeeeexxxxttttTTTTyyyyppppeeee ttttyyyyppppeeee, XXXXmmmmPPPPaaaarrrrsssseeeeTTTTaaaabbbblllleeee ppppaaaarrrrsssseeee____ttttaaaabbbblllleeee, CCCCaaaarrrrddddiiiinnnnaaaallll ppppaaaarrrrsssseeee____ccccoooouuuunnnntttt, XXXXttttPPPPooooiiiinnnntttteeeerrrr ccccaaaallllllll____ddddaaaattttaaaa); VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents Motif 2.1. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt converts characters specified in _t_e_x_t to corresponding components in the returned compound string. The resulting compound string consists of at least one locale or charset tag component and a series of XXXXmmmmSSSSttttrrrriiiinnnngggg text components and other components. The conversion proceeds according to the parse information contained in _p_a_r_s_e__t_a_b_l_e. See the _M_o_t_i_f _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e for more information about parsing and parse tables. +o If _t_y_p_e is XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT, the associated _t_a_g is interpreted as a charset name. If _t_a_g has a value of NULL, a charset component whose value is the result of mapping XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGGis created. +o If _t_y_p_e is XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT or XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT, the associated _t_a_g is interpreted as a language environment name. If _t_a_g has a value of NULL, a locale component with a value of ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE is created. If _t_y_p_e is XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT or XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT, _t_a_g must be NULL or ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE. XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt also scans the string for characters that have matches in _p_a_r_s_e__t_a_b_l_e. Whenever a match is found, the text up to that point is concatenated with the mapped component. _t_e_x_t Specifies the NULL-terminated string containing characters of a type determined by _t_y_p_e. This is updated to point to after the last character scanned. _t_e_x_t__e_n_d Specifies a pointer into _t_e_x_t. If a NULL is Page 1 (printed 4/6/01) XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt((((3333XXXX)))) supplied to the _t_e_x_t__e_n_d parameter, then XXXXmmmmSSSSttttrrrriiiinnnnggggPPPPaaaarrrrsssseeeeTTTTeeeexxxxtttt parses _t_e_x_t until NULL is encountered, or until it reaches a point in _t_e_x_twhere it is directed to stop (for example, by a ppppaaaarrrrsssseeee____pppprrrroooocccc). Otherwise, the value supplied to the _t_e_x_t__e_n_d parameter is the pointer into _t_e_x_t where parsing is to stop, and the returned character is the one where parsing did stop. _t_a_g Specifies the tag to be used in creating the result. The type of string tag created (charset or locale) depends on the text type and the passed in _t_a_g value. If the _t_a_g value is NULL and if _t_y_p_e indicates that a charset string tag should be created, the string tag has the value that is the result of mapping XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG. If _t_y_p_e indicates a locale string tag, the string tag has the value ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE. _t_y_p_e Specifies the type of text and the tag type. If a locale tag should be created, _t_y_p_e has a value of either XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT or XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT. If _t_y_p_e has value of XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT, a charset tag will be created. _p_a_r_s_e__t_a_b_l_e Specifies the parse table to be used in scanning for characters to be converted to other compound string components. _p_a_r_s_e__c_o_u_n_t Specifies the number of entries in _p_a_r_s_e__t_a_b_l_e. _c_a_l_l__d_a_t_a Specifies data to be passed to the parse procedures. RRRREEEETTTTUUUURRRRNNNN Returns a new compound string. The function allocates space to hold the returned compound string. When the application no longer needs the returned compound string, the application should call XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee. RRRREEEELLLLAAAATTTTEEEEDDDD XXXXmmmmSSSSttttrrrriiiinnnngggg(3), XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee(3), XXXXmmmmPPPPaaaarrrrsssseeeeTTTTaaaabbbblllleeee(3), XXXXmmmmPPPPaaaarrrrsssseeeeMMMMaaaappppppppiiiinnnngggg(3). Page 2 (printed 4/6/01) 
